home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Memphis Amiga Group / MAG Disk (1989-12)(Memphis Amiga Group).zip / MAG Disk (1989-12)(Memphis Amiga Group).adf / DiskX.DOC < prev    next >
Text File  |  1986-11-06  |  14KB  |  304 lines
  1.  
  2.  
  3.                                 DiskX  V2.0
  4.                                 -----------
  5.  
  6.                               by Steve Tibbett
  7.                               ================
  8.  
  9. <Features new to this version are covered at the end of this document>
  10. <The obligatory "Send Me Something for this Program" at the end also.>
  11.  
  12. Hi there.
  13.  
  14. One day I was happily using DiskEd, the Commodore-supplied Disk Editor,
  15. when I realized that I wasn't really "Happily" using it.  The Amiga is
  16. a mouse-based graphics-oriented system.  DiskEd is designed to confuse
  17. everybody except the person who wrote it, unless you are willing to
  18. spend a good bit of time learning how to use it.  This shouldn't be.
  19.  
  20. Enter DiskX.  Yeah, yeah, it's a stupid name.  You got a better one?
  21.  
  22. DiskX's main purpose in life is to be a Sector-based Disk Editor (as opposed
  23. to a File based editor, such as FileZap).  DiskX can also be used as a
  24. file editor, how to do this will be discussed a bit later on.  (geez, this
  25. sounds like a manual, doesn't it?).
  26.  
  27. I suppose I should start putting those little title things in here so people
  28. know which parts to skip over:
  29.  
  30. Overview:
  31. ---------
  32. DiskX lets you view the disk in a block-by-block format.  It also gives
  33. you the capability to FIND strings of text anywhere on the disk, to find the
  34. First block of any file, to view each block either as the mass of Hex
  35. numbers it really is, and the ability to view the block as what it REALLY
  36. is (i.e., File Header Block, User Directory Block, etc.).  The different
  37. block types there are can be found in the AmigaDOS manual by Bantam.
  38.  
  39. What is a DOS DEVICE?
  40. ---------------------
  41. DiskX lets you look at anything that AmigaDOS sees as a device.  If you have
  42. a Hard Disk, there should be a hddisk.device, jdisk.device, or something
  43. similar in your DEVS: directory on your workbench disk.  This also goes for
  44. the VD0: recoverable ram disk, which has asdg.vdisk.device there.
  45.  
  46. Note that the RAM: disk is NOT really a DOS device.  The Ram Disk is managed
  47. by the RAM-HANDLER in the L directory, thus making it ineligable (or
  48. inelegable or inelegible depending on whether you teach spelling or not).
  49.  
  50. Also, DiskX will not allow you to look at the PAR:, PRT:, SER:, NIL:, or
  51. anything else that isn't a device, because printers and modems don't like
  52. being asked to return a specific cylinder.
  53.  
  54. Modes of Operation:
  55. -------------------
  56. DiskX has two modes of operaiton, HEX mode and INTERPRET mode.
  57.  
  58. Hex Mode:
  59. ---------
  60. Hex Mode will allow you to look at what is actually in the block, 256 bytes
  61. at a time.  If you are looking at the first half of the block, the offset
  62. will be less than 100 (in Hex).  The offset is displayed at the bottom right
  63. of the screen somewhere, and reflects the current position of the cursor.
  64.  
  65. The cursor can be moved around either with the mouse (Point and Click), or
  66. with the Cursor Keys.  Pretty simple, eh?
  67.  
  68. While in hex mode, hitting the return key will allow you to enter Ascii Text
  69. starting at the current cursor position.  Just move the cursor to where you
  70. want to start, hit Return, type in your text, then hit Return again.  Note
  71. that the cursor keys will not work when you are entering text, but the Mouse
  72. Pointer will still allow you to move the cursor.
  73.  
  74. When you are in Hex mode, there are a couple of extra Gadgets (the square,
  75. obnoxious-looking things) that pop up on the bottom of the screen.
  76. There's the 'Other Half' gadget, which will show you the other half of the
  77. block, there's the Modify gadget, which will let you edit the contents of
  78. that byte in either Hex, Decimal, or Binary, and then there's the Show Type
  79. gadget, which will flip you into:
  80.  
  81. Interpret Mode:
  82. ---------------
  83. This is where the excitement lies.
  84.  
  85. In Interpret mode, instead of just showing you what is in the block as
  86. Hex, it tries to make some sense out of the block the same way AmigaDOS
  87. does, showing you only the contents of the block that are relevant to that
  88. block type.  For instance, if the block is a Data Block, you will see the
  89. contents of actual DATA part of the block in the middle of the screen, and
  90. at the top of the screen you will see where that block's File Header Block is
  91. located, what it's Sequence Number is, where the Next Block is, and the Size
  92. of that block.
  93.  
  94. When you're in Interpret mode, a few other keys come into play, also depending
  95. on what type of block you are looking at.  The left and Right cursor keys
  96. will move up/down by one block.
  97.  
  98. R will move you to that disk's ROOT lock.  P will bring you to that block's
  99. Parent Block (If it has one).  N will bring you to the Next block, if the
  100. current block type supports it.  W will tell it to Write the block back
  101. to the disk, and E won't do a darn thing.
  102.  
  103. Also, if the block type supports it, you will get either a "First Block",
  104. "Next Block", or a "Parent Block" gadget on the screen.
  105.  
  106. Find:
  107. -----
  108. Find will let you search for a string of text.  Just type in the string,
  109. then select either to start from Here (the current Block Number), or from
  110. Block #0.
  111.  
  112. Key # vs Block #:
  113. -----------------
  114. The terms Key and Block get used fairly often here - they both mean the exact
  115. same thing.  They refer to the current Block Number, which is how far into
  116. the disk we are in 512 byte blocks.
  117.  
  118. Parent Block and Header Block:
  119. ------------------------------
  120. These two terms end up being used a good bit in the program - again, they
  121. both mean the same thing, they mean the block that this block is pointed
  122. to by. <make sense?>
  123.  
  124. Getting Out:
  125. ------------
  126. All good things must come to an end, and you've got three ways to end it all
  127. from here:  Hit Escape, click on the Quit Gadget, or use the Quit menu option
  128. and you're out.
  129.  
  130. Notes:
  131. ------
  132. DiskX will only work properly on devices which use a 512 byte block.  I
  133. have yet to see one that uses a different sized block, so it didn't seem
  134. like a big problem.
  135.  
  136. If you want to change anything on your KickStart disk, there is a Public
  137. Domain Program out there called SumKick, which will fix the checksum
  138. on the KS disk for you after you've changed it.  Otherwise, whenever
  139. you Reboot, it will want Kickstart back.
  140.  
  141. Uses:
  142. -----
  143. After reading all this, you're saying "Great, but what will I use it for?".
  144. Well, here are some uses:
  145.  
  146.   If you live in Canada, (like all the real people in the world, eh?  Turn
  147.   the heat up, Bob.), you can take any program which refers to "State"
  148.   and change it to refer to "Prov." using the Find command.
  149.  
  150.   You can read the text in the Virus without ever allowing the Virus to load
  151.   into your machine by putting a disk with the Virus on it in the external
  152.   drive, and looking at Block #1 in ASCII mode.
  153.  
  154.   You can find hidden messages in your Kickstart disk.
  155.  
  156.   You can dig through your favorite game to find all kinds of strings which
  157.   may be helpful.
  158.  
  159.   You can waste a lot of time going through programs which hide any ASCII
  160.   text contained in them.
  161.  
  162.   Using the Write Block to File option, you could take any auto-booting
  163.   disk (the kind that uses the boot sector to load the game), write it
  164.   to a file, and disassemble it or whatever.
  165.  
  166. ----------------------------------------------------------------------------
  167.  
  168. New Features in DiskX:
  169.  
  170.  - It now works with ANY device!
  171.  - Ability to Search the disk for ascii strings without being case-sensitive.
  172.  - Ability to recover a deleted file from any device.
  173.  - Ability to view ALL ascii strings on the disk, in a simple manner.
  174.  
  175. When you go to Search (using the Find... gadget on the main screen), if 
  176. the first character of the pattern you are searching for is an
  177. Asterisk ("*"), it will ignore the case of the string it is searching for.
  178. (If you tell it to search for *Hello, it would find Hello, hELLO, HeLlO, or
  179. any other variation).
  180.  
  181. If the first character of the pattern you enter to search for is an
  182. "@" (at sign), DiskX will treat this as though you were looking for a
  183. file name - it will ignore case, and will only stop at blocks which are
  184. file headers whose filename matches this pattern.  More on this later.
  185.  
  186. You can now search the whole disk, starting at either block Zero or from
  187. the current position, for ANY ascii text (It will display any text
  188. string longer than 6 characters).  It's a menu option.  Also, if you
  189. select the "Through Links" option, you can start searching from a file
  190. header (using the "Find File Header" menu option to find the file header)
  191. to search through a particular file for text.  Also, take a look through
  192. the Kickstart disk - there's lost of neat stuff on there.
  193.  
  194.  
  195. Recovering Files:
  196. -----------------
  197. You've just deleted a file.  The file's name is LostFile, and it is on
  198. DH0:.  Here's how to get it back:
  199.  
  200. 1.  Select the DH0: menu option on the Project menu (in the Unit Number
  201.     submenu).  Same thing applies for any device.
  202.  
  203. 2.  Click on the Find... gadget on the bottom of the main screen.  Tell
  204.     it to search for "@LostFile".  This will find LostFile's file header
  205.     block and make it the current block.  (Remember that the @ sign tells
  206.     DiskX that you're looking for a file header) (You will probably have to
  207.     hit the "Show Type" gadget to get it to tell you that it is a file header,
  208.     as after doing a Search, DiskX defaults to Hex mode) (Not any more!).
  209.     Note that doing a Find on a hard disk can take a good bit of time.
  210.  
  211. 3.  Select the "Recover..." menu option..  DiskX will now search through
  212.     the entire disk for any block whose Parent block field points to the
  213.     file header for LostFile (any block belonging to Lostfile).
  214.  
  215. 4.  When it's done, there will be a file requester asking you where you
  216.     want the file to be written to.  DO NOT WRITE THE FILE TO THE SAME
  217.     DEVICE YOU ARE RECOVERING IT FROM.  While the chances are you
  218.     won't have any major problems doing it, things could go wrong.  A safe
  219.     place to write to is the RAM: disk, and it's the default drive when
  220.     this requester comes up.
  221.  
  222. 5.  After you've entered the new name for the file here, hit OK (or hit
  223.     return), and the file will be recovered.  That's it.
  224.  
  225.   It sounds like a lot of work, but after you've done it once, it's actually
  226.   pretty easy.
  227.  
  228.      ->  Any other ideas?  What would YOU like in a disk editor??  <-
  229.  
  230.  
  231. ----------------------------------------------------------------------------
  232.  
  233. Another new feature:
  234.  
  235. On the special menu, there is an option to write the current block to
  236. a file.  The first time you select this option, you will be asked for
  237. the filename you want to write the data into.  Each time you go for
  238. this option after that, it will write the block into the same file (If
  239. you haven't closed it already).  If you plan to write a number of blocks
  240. during the same session (say to write the 2 boot blocks into a file so
  241. you can disassemble it), just don't close the file after each write, wait
  242. until you have written all you want to write, and then close the file.
  243.  
  244. If the block you are writing is a Data Block (part of a file), only the
  245. data part of the block (488 bytes) will be written, otherwise all 512 bytes
  246. (including the block's checksum) will be written.
  247.  
  248. If you forget to close the file before quitting, DiskX closes it for you.
  249.  
  250. -----------------------------------------------------------------------
  251.  
  252. If you own a device other than the ones listed on the Unit menu,
  253. to get to it, use the Find File Header command.  Enter the device name
  254. you want to get to into the Drawer gadget, and nothing in the filename
  255. area.  Hit OK, and you should be there.
  256.  
  257. -----------------------------------------------------------------------
  258.  
  259. DiskX should now work correctly with HD partitions - If it will read from
  260. it properly, it will write to it properly.  It also takes into account
  261. the area at the beginning of some drives for mapping bad sectors into -
  262. it won't redirect the bad sectors to there, but it will ignore that space.
  263. Anyways, on some drives, it gets confused as to where the root block is.
  264. If when you first select the drive, the block you see is NOT of type
  265. Root Block, you are going to have to go up or down a cylinder or two
  266. to find it.  It's just a minor hassle - also, the "Disk Info" menu option
  267. will show the Disk's name wrong.
  268.  
  269. -----------------------------------------------------------------------
  270.  
  271. Note that DiskX becomes a lot nicer to use (if you use it a lot) if you run
  272. one of the Text speedup programs available (BlitzFonts, FastFonts).
  273. BlitzFonts is a good candadate, since it's a PD program.
  274.  
  275. -----------------------------------------------------------------------
  276.  
  277. Plea to your good nature:
  278. -------------------------
  279. Y'know, folks, this Amiga device is great, but nobody seems to be able
  280. to make anything cheap for it.  I'm just about to pay $1400 (in Canadian
  281. bucks - ouch) for a hard drive, and, well, I could use some form of
  282. $$ for this program.  I was looking at Sectorama recently, (Nice program
  283.  - I stole a bunch of ideas from it for here), and I think I'm going
  284. to steal something else from it:  His idea of compensation for a
  285. "Freeware" program.
  286.  
  287. If you like DiskX, you can either do Absolutely nothing about it and just
  288. hope I manage to stay alive and keep making these things, or you can do
  289. something about it.  What you can do is either send me some cash, which
  290. I really wouldn't object to, or, send me something you've written.
  291. Anything.  If you're a developer, well, I probably couldn't afford to BUY
  292. whatever it is you're developing anyways, and it wouldn't cost you much
  293. to make me happy... <grin>
  294.  
  295.               Steve Tibbett
  296.               2710 Saratoga Pl. #1108
  297.               Gloucester, Ontario
  298.               CANADA K1T 1Z2
  299.  
  300. I mean, hey, I got 3 (count 'em, THREE) letters from people who liked the
  301. original DiskX.  It wasn't THAT bad, was it?
  302.  
  303.  ...Steve
  304.